Windows下OpenCode的安装与配置（三）——Oh My OpenCode 插件与 Skills 安装

前两篇把 OpenCode 装好了、模型也接上了，现在它已经是一个能正常干活的 AI 编程助手了。但如果只是这样，它和一个普通的 AI 聊天工具区别不大。

这一篇要装的两样东西，才是让 OpenCode 真正拉开差距的地方：Oh My OpenCode 插件 和 Skills 技能包。

Oh My OpenCode 是什么

Oh My OpenCode（现已更名为 Oh My OpenAgent）是 OpenCode 生态中最重要的第三方插件。它做了一件事：把 OpenCode 从一个"单兵 AI"变成一个"多智能体协作系统"。

装完之后，你的 OpenCode 里会多出好几个专门角色：

这些角色可以配置不同的模型。比如 Sisyphus 用 Claude Opus 做主控，其他角色用 GPT 来执行。这样既保证了质量，又控制了成本。

安装 Oh My OpenCode

前置依赖：Bun

Oh My OpenCode 的安装器用 bunx 运行，所以你需要先装 Bun。

npm install -g bun

安装后确认：

bun --version

提示：Bun 在 Windows 上的原生支持还在不断完善中。如果安装遇到问题，可以考虑使用 WSL 来运行安装命令，然后回到 Windows 下的 OpenCode 使用。

运行安装向导

bunx oh-my-opencode install

安装向导会引导你完成以下步骤：

1. 检查 OpenCode 是否已安装 — 如果没装，它会提醒你先去装
2. 选择你拥有的 AI 服务订阅 — Claude、OpenAI、Gemini 等，勾选你有的
3. 配置 API Key 和认证方式 — 根据你选的服务逐一配置
4. 生成配置文件 — 自动写入 oh-my-opencode.json 和更新 opencode.json

安装完成后，运行诊断确认一切正常：

bunx oh-my-opencode doctor

这条命令会检查所有依赖和配置是否正确，有问题它会告诉你怎么修。

安装后的文件变化

安装完成后，你会发现以下变化：

opencode.json 多了一个 plugin 字段：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    ...
  },
  "plugin": [
    "oh-my-openagent"
  ]
}

新增了 oh-my-opencode.json 配置文件：

这个文件在 C:\Users\你的用户名\.config\opencode\ 目录下，用来配置各个智能体角色使用的模型。

手动安装方式（备选）

如果 bunx 安装向导遇到问题，你也可以手动安装。

第一步：在 opencode.json 的 plugin 数组里添加插件：

{
  "plugin": [
    "oh-my-openagent"
  ]
}

OpenCode 启动时会自动通过 Bun 安装这个 npm 包。

第二步：创建 oh-my-opencode.json 配置文件。

配置智能体模型分配

oh-my-opencode.json 的核心就是给每个角色分配模型。格式如下：

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json",
  "agents": {
    "sisyphus": {
      "model": "anthropic/claude-opus-4-20250514",
      "variant": "max"
    },
    "hephaestus": {
      "model": "openai/gpt-4o",
      "variant": "medium"
    },
    "oracle": {
      "model": "openai/gpt-4o",
      "variant": "high"
    },
    "librarian": {
      "model": "openai/gpt-4o"
    },
    "explore": {
      "model": "openai/gpt-4o"
    },
    "prometheus": {
      "model": "openai/gpt-4o",
      "variant": "max"
    },
    "metis": {
      "model": "openai/gpt-4o",
      "variant": "max"
    },
    "momus": {
      "model": "openai/gpt-4o",
      "variant": "high"
    }
  },
  "categories": {
    "visual-engineering": {
      "model": "openai/gpt-4o",
      "variant": "high"
    },
    "ultrabrain": {
      "model": "openai/gpt-4o",
      "variant": "high"
    },
    "deep": {
      "model": "openai/gpt-4o",
      "variant": "medium"
    },
    "quick": {
      "model": "openai/gpt-4o"
    },
    "writing": {
      "model": "openai/gpt-4o"
    }
  }
}

几个要点：

• model 格式：provider名/模型ID，这里的 provider 名和模型 ID 要跟你在 opencode.json 里配的一致
• variant：对应模型配置里的 variants 字段，控制思考深度或推理强度
• agents：控制每个智能体角色用什么模型
• categories：控制不同类型任务用什么模型，比如前端任务走 visual-engineering，简单任务走 quick

省钱建议：主控角色 Sisyphus 用强模型（如 Claude Opus），其他执行角色用便宜一点的模型（如 GPT-4o）。这样既保证了任务理解和调度的质量，又不会因为每个子任务都用顶级模型而花太多钱。

Skills 是什么

Skills 是 OpenCode 的"技能包"系统。每个 Skill 就是一份 Markdown 文件，告诉 AI 在特定场景下应该怎么做。

比如你装了一个 systematic-debugging 技能，当你遇到 Bug 时，AI 就不会盲目乱改代码，而是按照技能里定义的流程来排查：先收集信息、形成假设、验证、再修复。

Skills 不是代码，是行为指南。它们让 AI 在特定领域的表现从"通用"变成"专业"。

Skills 的存放位置

OpenCode 会从以下目录自动发现 Skills：

~/.agents/skills/<name>/SKILL.md        ← 全局用户级（推荐）
~/.config/opencode/skills/<name>/SKILL.md
.opencode/skills/<name>/SKILL.md        ← 项目级
.agents/skills/<name>/SKILL.md

在 Windows 上，全局用户级路径就是：

C:\Users\你的用户名\.agents\skills\技能名\SKILL.md

每个 Skill 是一个文件夹，里面放一个 SKILL.md 文件。文件夹名就是技能名。

安装 Skills

Skills 的安装本质上就是把文件放到对应目录。有几种方式：

方法一：通过 Oh My OpenCode 内置命令（推荐）

如果你已经装了 Oh My OpenCode，在 OpenCode 对话中直接说：

帮我安装 obra/superpowers 的所有 skills

AI 会自动去 GitHub 下载并安装。

方法二：手动从 GitHub 下载

大部分 Skills 都托管在 GitHub 上。以最常用的 obra/superpowers 技能包为例：

# 克隆仓库
git clone https://github.com/obra/superpowers.git

# 把 skills 目录下的内容复制到全局 Skills 目录
xcopy /E /I superpowers\skills "$env:USERPROFILE\.agents\skills"

方法三：手动创建

如果你想写自己的 Skill，创建一个文件夹和一个 SKILL.md 文件就行：

mkdir "$env:USERPROFILE\.agents\skills\my-custom-skill"

然后在里面创建 SKILL.md，格式如下：

---
name: my-custom-skill
description: 我的自定义技能
---

## 技能说明

在这里写你希望 AI 遵循的行为规范...

推荐安装的 Skills

下面按用途分组，列出值得安装的 Skills。你不用一次全装，先装核心的，其他按需补充。

核心工作流 Skills

这几个最值得先装，它们会直接影响 AI 的工作质量：

代码质量 Skills

文档处理 Skills

专业领域 Skills

可视化 Skills

辅助 Skills

安装后验证

所有 Skills 安装完成后，启动 OpenCode，AI 会自动发现已安装的 Skills。你可以问它：

列出我已安装的所有 skills

它会返回一个技能清单。如果某个 Skill 没有出现，检查一下文件路径和 SKILL.md 的格式是否正确。

完整的目录结构参考

装完所有东西后，你的配置目录应该大概长这样：

C:\Users\你的用户名\
├── .config\
│   └── opencode\
│       ├── opencode.json              ← 主配置（Provider + Plugin）
│       ├── oh-my-opencode.json        ← 智能体角色配置
│       ├── package.json               ← 自动生成的依赖声明
│       ├── node_modules\              ← 自动安装的依赖
│       └── local-plugins\             ← 本地插件目录
│           └── oh-my-opencode-runtime\
└── .agents\
    └── skills\
        ├── systematic-debugging\
        │   └── SKILL.md
        ├── verification-before-completion\
        │   └── SKILL.md
        ├── brainstorming\
        │   └── SKILL.md
        ├── writing-plans\
        │   └── SKILL.md
        ├── pdf\
        │   └── SKILL.md
        ├── docx\
        │   └── SKILL.md
        ├── ...
        └── (更多 Skills)

小结

这一篇完成了：

1. Oh My OpenCode 安装 — 通过 bunx oh-my-opencode install 安装多智能体插件
2. 智能体模型分配 — 在 oh-my-opencode.json 里给不同角色配不同模型
3. Skills 安装 — 从 GitHub 下载技能包到 ~/.agents/skills/ 目录
4. 推荐 Skills 清单 — 按用途分类列出了 24 个实用技能

到这里，整个 OpenCode 的安装配置就全部完成了。你已经拥有了一个多智能体协作的 AI 编程助手，而且它根据不同的任务场景会有不同的专业表现。

系列总结

回顾一下这个系列的三篇文章：

1. 前言与安装 — 装好 Node.js、Git，通过 npm 安装 OpenCode
2. 配置与模型接入 — 写 opencode.json，接入 Claude / GPT / 中转站
3. 插件与 Skills — 装 Oh My OpenCode 多智能体插件，装 Skills 技能包

从零到完全可用，跟着走下来大概需要 30 分钟。这套工具链搭好之后，你的日常编程体验会有很明显的变化。它不只是帮你补全代码，而是真的能理解你的项目、帮你规划方案、写代码、跑测试、做 Review，像一个不会累的队友一样。

如果你在配置过程中遇到问题，可以查阅以下资源：

• OpenCode 官方文档
• OpenCode GitHub
• Oh My OpenAgent GitHub
• obra/superpowers Skills